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Command> show clock 
' * 04:10:12. 621 UTC Thu May 6, 1993 



/-\^Command> snow clock detail 
205 *04.1 0.1 8.1 09 UTC Thu May 6, 1 998 
Time source is user configuration 



f </xml version="1 .0" endodings="US-ASCII"?> 
<!DOCTYPE cli SYSTEM "cli.dtd'i> 
<cli> 

<mode name='£jlobar!> 

<command> 

<keyword text='show'^ 

<help>Show running system information</help> 
<!=!ots of other show keywords. . . --> 

<keyword text='tlock'!> 

<?help>display the system clock</help> 
<action object='Clock"method= , show'i> — \_ 
</action> 

<keyword text='tletairi> 
<help>Display detailed information </help> 
action object='Clock" method='showDetairi> 
</action> \ 
</keyword> r> 
</keyword> ^ 
</keyword> 
</command> 
</mode> 
^ </cli> 
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Command > clock set? 
32 <j^ hh:mm:ss Current Time 

Command > clock set 00:00:00 ? 
^ <1 -31 > Day of the Month 
^ Month of the Year 

Command > clock set 00:00:00 25 Sep ? 
32 ^^<1993-2035>fear 
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Command > clock set 00:00:00 25 Sep 2000 
Command > 
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ru 
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<command> 

<keyword text="clock'i> 
<help>Manage the System clock</help> 
<keyword text="set'!> 328 

<heip> Set the time and date</help> 
<action object="Clock" method="set'!> 
<arg> <!-time argument ~> 

<type type="java.land.String"></type> 
<help>hh:mm:ss Current Time </help> 
</arg> 

<arg> <!-day of the month argument -> 

<type type="java.lang.lnteger"></type> 
<help>&1t;1-31> Day of the month</help; 
</arg> 

<arg> <!-day of the month argument --> 
<type type="java.lang.lnteger"></type> 
<help>Month Month of the year </help>- 
</arg> 

<arg> <!-year argument ~> 
<type type="java.lang.lnteger"></type> 
<help>&1t;1993-2035> Year</help> ^ 
</arg> 
</action> 
</keyword> 
</keyword> 
</command> 
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<?xml version ='1 .0' encoding="us-ascii'?> 
<!-DTD for cli description file — > 

<!-The cli tag is the topmost element. Contains zero or more modes. --> 
<!ELEMENT cli (mode*)> 

<!--The mode tag contains zero or more command tags. The mode must 
have a name, for example "golbal", " exec", " config" --> 

<!ELEMENT mode (command*)> 

<!ATTLIST mode 

name CDATA#REQUIRED 

> 

. <!-The command tag contains a single keyword--> 
<!ELEMEI\IT command (keyword)> 

<!--The keyword tag contains zero or more subkeywords, with an optional 

single instance of action or help. The single attribute is the keyword test 

which must be present --> 
<!ELEMENT keyword ((keyword)*, action?, help?> 
<!ATTL!ST keyword 

test CDATA #REQUIRED 

> 

<!-- The action tag contains zero or more argument tags. The "object" 
and "method" attributes must be present and defined" 
<!ELEMEI\IT action (arg*)> 
<!ATTLIST action 

object CDATA #REQUIRED 

method CDATA#REQUIRED 

> 

<!-- The arg tag contains a single instance of a type tag and an 
optional help tag --> 
<!ELEMENTarg(type,help?)> 

<!--The type tag is an empty tag with a required attribute "type". The 

value of the attribute should be a Java class name --> 
(IELEMENT type EMPTY)> 
<!ATTLIST arg 

type CDATA #REQUIRED 

> 



<!-- The help tag encloses some text --> 
<!ELEMENT help (#PCDATA)> 
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DEFINE 
COMMANDS 


1 


F 


DESIGN 
PLATFORM 
INTERFACES 




t 


CREATE XML CLI 
DESCRIPTION 
FILES 
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BUILD 
.CLI FILES 
AND TEST 
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Command 


Keyword Set 


show date 


("show"," date') 


show date detail 


("show"," date"," detail') 


clock set 


("clock"," set') 
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Argument 
Number 


Argument Description 


Argument Heip 


1 


Time in 00:00:00 format 


hh:mm:ss Current time 


2 


day of the month in integer 
format 


<1-31> Day of the month 


3 


month in three letter 
format 


MONTH Month of the Year 


4 


Year in integer format 


<1993-2035>Year 
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Command 
Keyword Sequence 


Help 


show 


show running system Information 


clock 


Manage the system clock 


show clock 


Display the system clock 


show clock detail 


Display detailed information 


clock set 


Set the time and date 
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<?xml version='1.0 encoding=*US...ASCir ?> 

<! DOCTYPE cli SYSTEM "cli.dtd'!> 

<cli> 

<mode name="exec'^ 



<command> 

<keyword text= "show" > 

<help>Show running system information</help> 

.... <!— lots of other show keywords... --> 

<keyword text=" clock'> 
</help>Display the system clock </help> 
<action object="Clock" methods "show"^ 
</action> 

<keyword text="detall'!> 
<help>Display detailed information</he!p> 
action object="Clock" method="showDetail'^ 
</action> 
</keyword> 
</keyword> 
< / command> 
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<command> 

<keyword text="clock" 
<help>Manage the System clock</help> 



<keyword test="set'i> 

<help> Set the time and date</help> 

<action object="Clock" method="set'^ 

<arg><!- time argument ~> 
<type type="Java.land.String"></type> 
<help>hh:mm:ss Current time</help> 
</arg> 

<arg> <! - day of the month argument ~> 
<type type=Java.land.lnteger"></type> 
<help><1-31> day of the month</help> 
</arg> 

<arg> <! - day of the month argument --> 
<type type="Java.land.lnteger"></type> 
<help>MONTH Month of the year</help> 
</arg> 

<arg> <! - year argument -> 
<type type="Java.land.lnteger"></type> 
<help><1993-2035> Year</help> 
</arg> 

</action> 
</keyword> 
</keyword> 
</command> 
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public void show () { 

SimpleDateFormat formatter = 
new SimpleDateFormat ("hh:mm:ss.SSS zzz EEE 
MMM dd yyyy"); 

System.out.println("*" + formatter.format 
(new DateQ)); 
} 

public void showDetail () { 

this.show(); 

if (Clock.source()) 

System.outprintln ("Time source is user 
configuration"); 

else 

System.outprintln ("No time source"); 
} 
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public void set (String time, Integer day, String month, Integer year) 

throws lOException, InterruptedException, CLIArgumentException 

( 

/ / Validate the arguments 
SimpleDateFormat format = new SimpleDateFormat ("hh:mm:ss) 
format.setLenient (false); 
try { format parse (time) 
} catch (ParseException e) { 

throw new ArgumentException (1); 

> 

if (day.intValueO < 1 1 1 day.intValue() > 31) 
throw new ArgumentException (2); 

formatapplyPattem ("MMM"); 
try { f ormatparse(month); 
} catch (ParseException e) { 

throw new ArgumentException (3); 

} 

if (year.intValue() < 1 993 1 1 year.intValue 0> 2035 
throw new ArgumentException (4); 

// One last check for day, month and year validity (e.g., Feb 31 ) 
formatapplyPattem (" dd MMM yyy"); 
try { format.parse(day.toString() + month + year.toString()); 
} catch (parseException e) { 

CLIEngine.outprintln("lnvalid date (doesn't exist)"); 

Return; 

} 

// Do the actual work 
String [] cmd = {" /bin/date", " -s", time + + day + + month + "" 
}; 

Process proc = Rumtime.getRuntime().exec (Cmd); 
proc. waitFor(); if (proc.exitValue() > 0) { 
CLIEngine.err.println("Operation not permitted"); 
return; 

} 

clock.sourceSet() ; 
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